build: update release cadence - #89

Review Summary

Overall this is a reasonable release-cadence update, but the config-docs auto-generation piece has one critical dead-code bug that should be fixed before merge:

🔴 Critical

• generate_config_reference.py imports new *_DESCRIPTIONS dicts from schema.py, but they're immediately shadowed by pre-existing local dict literals later in the same file — the import has zero effect on generated docs (verified empirically with a marker-string test). See inline comment for details and the fix path.

🟡 Suggestions

• The new schema.py description dicts are also stale/incomplete relative to the local copies they're meant to replace (missing web_request/workflows entries) — worth reconciling now while fresh, since it'll block the eventual cleanup of the dead local dicts.
• docs/AUTO_GENERATION.md now tells contributors to edit schema.py for descriptions, which is misleading until the above is actually fixed.
• versionPattern's default was narrowed to double-quotes-only, inconsistent with the template it calls (which still supports both quote styles) — likely fine today but worth confirming it's intentional.
• Re: the cross-stage variable propagation (also flagged in the existing comment on the Build stage below) — it's not just boilerplate, build-artifacts.yml/publish-release.yml genuinely need libraryVersion before checkout. But ResolveVersion could be folded into BumpVersion's job as its first step, dropping one stage's pool spin-up and trimming the repeated stageDependencies blocks from 3 copies to 2. See inline comment for specifics.

🟢 Looks good

• The new trigger/pr: none block is a well-justified fix for unwanted default-branch pipeline triggers.

Happy to help with the fix for the dead-code issue if useful.

Pull request overview

This PR updates the release pipeline to auto-trigger releases on src/** changes and auto-compute the next beta version when libraryVersion isn’t provided, while also relocating doc-generation field description metadata from the generator script into schema.py (so the schema remains the source of truth for enhanced field descriptions).

Changes:

• Add src/**-scoped pipeline trigger + a new ResolveVersion stage to compute the next x.y.zb(n+1) version when libraryVersion is empty.
• Move *_DESCRIPTIONS / defaults dictionaries out of eng/scripts/generate_config_reference.py into src/azure_functions_agents/config/schema.py.
• Update documentation/process guidance to reflect where field description metadata lives.

Reviewed changes

Copilot reviewed 5 out of 5 changed files in this pull request and generated 2 comments.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.